═══ 1. Notices about copyright, distribution and warranty ═══ Copyright (c) 1991-1993 Th. Wentzlawski General Distribution by: VTS-Datensysteme GmbH & Co 20317 Hamburg P.O. Box 305583 FAX +49 40 453873 (Germany) CompuServe: 100277,1363 DISCLAIMER THE USER OF THE PROGRAM BY USING IT AGREES NOT TO HOLD THE AUTHOR NOR THE DISTRIBUTOR LIABLE FOR ANY DAMAGE THAT MAY HAVE BEEN CAUSED BY EITHER THE PROPER OR IMPROPER FUNCTIONING OR BY THE USE OR MISUSE OF THE ADU/2 SYSTEM. ═══ 2. Introduction ═══ Introduction to the ADU/2 System. ═══ 2.1. What is ADU/2 ? ═══ What is ADU/2 ? ADU/2 is a file and directory management tool intended for administrators of large disks running in an OS/2 environment. Two years ago it's main focus were great enterprise LAN's consisting of many IBM LAN-Servers or Microsofts LAN-Managers. (OS/2 Netware clients are appreciated as well especially if OS/2 naming support runs at the server). A GUI based tool may be nice, but if time is money ..... In 1993 a lot of people run the superior OS/2 HPFS instead of the FAT file system and they would like to exploit the new features. And that's exactly what ADU/2 supports. It handles easily all of the trivial file and directory operations with LONG FILENAMES by preserving the EXTENDED ATTRIBUTES. ADU/2 is a fast filemanager with a text-based interface. ADU/2 runs either in a PM-Window or fullscreen session. ═══ 2.2. Highlights ═══ ADU/2 Highlights o HPFS Support (EA's and Long Filenames) o No installation required o Small, so it is startable from diskette o Causes less than 3% processor load while running idle in foreground and ca. 1% when switched to background o Does not modify systems ini files nor create any unwanted files o Usable on diskette booted systems ( PM or WPS not required ) o Save directory tree data to files. Very convenient for large and slow medias like CD-ROM or MO-Disks o Scanning, refreshing and display of subtrees o Detailed overview about the disk space consumption listed by directories and subtrees. o Very fast seek and scan files function with many options o Easy to use Hexeditor o Extreme low processor load while idle. Very important when running ADU/2 on servers. o Fine for IBM LAN-Server or Microsofts LAN-Manager network environments o UNC-Names are supported for most operations. ═══ 2.3. Philosophy ═══ The ADU/2 user interface reflects the main intention of the ADU/2 development: There should be no time consumption by opening, moving, sizing windows and menues. Each action should be invoked by one or two keys. The provided menu is not necessary for using ADU/2. The menu is for beginners and could be used as a help for learning the short cuts. The help function invoked by F1 represents only a condensed overview about ADU/2's keys and functions. ADU/2 needs only one file for operating and that's ADU.EXE. So no installation is required and for service and maintenance in an organisation it's startable from diskette. ADU/2 does not modify any system files or create files by itself because that is unacceptable in LAN environments. Mouse support is included even there is mostly no gain in time, but you may find it convenient if ADU/2 runs in a windowed session. ═══ 3. Getting started ═══ Describing the installation, the invokation of ADU/2 and the Environment Variables. ═══ 3.1. Installation ═══ ADU/2 Filemanager consists of only one file and that's ADU.EXE. No other file is required; therefore no installation is necessary. For maintenance purposes ADU/2 could even be started from a diskette. In a static environment you should copy ADU.EXE in a directory which is a part of the path statement in config.sys file. ═══ 3.2. Starting and terminating of ADU/2 ═══ Starting and terminating of ADU/2 ADU/2 is simply invoked from an OS/2 command prompt either in a windowed or fullscreen session by typing ADU. Terminating ADU/2 is made easy. Experienced user will press ALT-X at any time they want to quit and there will be no boring prompt. Another way is to press ESCAPE until your are prompted for terminating ADU/2. ═══ 3.3. The ADUEDIT Environment Variable ═══ The ADUEDIT environment variable Pressing 'E' in the File/Directory screen invokes the OS/2 systems editor e.exe with the highlighted entry as a parameter. If you would like to call your favorite editor you could specify it in the option menu. By terminating ADU/2 this information is lost. Setting the environment variable ADUEDIT will overcome this problem. For permanent use in all sessions you have to do this in the config.sys. For example if your favorite editor is q.exe and you would like run q.exe in fullscreen mode, add the following line to your config.sys : SET ADUEDIT=Q.EXE /FS Other switches are /PM and /WIN. If no switch is given the program will determine the session mode. ═══ 4. Controlling the main working area ═══ Describing the very first steps after invoking ADU/2 and entering the main panel. ═══ 4.1. Navigating through lists and directory structures ═══ Navigating through lists and directory structures After starting ADU/2 it will load the contents of the current directory. ADU/2 displays this contents as a list. The default sort mode is by names with the subdirectories listed first. If the current directory is not the root directory the first list entry is the double dot. This indicates that their is a parent directory. ═══ 4.2. Open a quick action context menu ═══ Open a quick action context menu Clicking the right mouse button in list area opens a special quick action menu refering to the highlighted or marked item(s). ═══ 4.3. Display a long file/directory name ═══ Display a long file/directory name File/directory names exceeding the 8.3 FAT naming conventions may not be displayed with their full names. This is indicated by three succeeding dots. Zoom the highlighted entry to the full name by pressing 'Z'. In the file/directory list it's possible to scroll the names by pressing the right or left direction key. ═══ 4.4. Display modes ═══ Display 'last access' and 'creation' date Pressing F2 switches the displayed file date mode. Default mode is the FAT supported last 'write access'. Pressing F2 once switches to 'last access' mode and another F2 shows the files 'creation' dates. Get a file list with EA size Ctrl-X toggles display mode: Extended Attributes size and time data. ═══ 4.5. Grouping files and directories by using masks ═══ Grouping files and directories by using masks Advanced marking and unmarking entries for further processing could be done with '+' and/or '-'. You are prompted for a matching pattern. The OS/2 rules for wildcards apply. Example: You want to copy the source- and header files of the current list by excluding all files beginning with 'ad'. 1. Press '+' and type *.c for the first pattern. Matching entries will be marked. 2. Press '+' and type *.h Matching entries will be additionally marked. 3. Press '-' and type ad* for the exclude pattern. Previous marked entries matching the exclude pattern will be unmarked. 4. Invoke the copy process by pressing Ctrl-C ═══ 4.6. Marking and Unmarking of list entries ═══ Marking and Unmarking of list entries Mark a single file with the SPACE bar while it is the highlighted entry. If this entry is already marked it will be unmarked by pressing the SPACE bar. Another method is the use of masks (see 'Grouping files and directories by using masks' ). To mark all entries except directories use Ctrl-T. If you want to mark all entries including the directories, use the mask method by pressing '+' and apply the mask * . Unmarking of all entries could be done with Ctrl-U. ═══ 4.7. Working with two lists ═══ Display two list For convenient file/directory move and copy operations open a second list by pressing CTRL RETURN. The inactive list is always the default target path for copy and move operations. The TAB key changes the active list. Note ! Once opened, you could never close the second list. Ctrl-Return will return to the single list display, but the second list is still in memory. The TAB key will make this list active. ═══ 4.8. Locating a list entry ═══ Locating a list entry To ease the find of an entry in a big list use the 'find string' function by pressing F . Type a significant part of the file/directory name in the dialog box entry field. The find process invoked by 'F' searches all list entries for a match at any position in the file/directory name. The search is not case sensitive. To locate the next matching list entry press N. Pressing N allways starts the search from the highlighted list position even if you have done some movements of this position after the last find process. ═══ 4.9. Sorting the list ═══ Sorting the list The default sort mode is 'by names'. Change the sort mode by opening the sort menu with the key S and make your choice. The following modes are supported: Sort by: o Name o Attribute o Date o Extension o Size ( File size ) Although the OS/2 knows no explicit extension ( there could be more then one dot in the filename ) sorting is done by considering the part after the last dot. To ease the traversing of the directory structures, the sort mode 'by name' will always sort directories first. The default sort order is descending. Change this to ascending by pressing '+' in the sort menu. Note ! There are operations like a renaming which may change the sort order. There is no automatic refresh of the list in those cases. You could initiate a refresh of the sorting by 1) selecting the same sort criterion ( the fastest way ) or 2) by pressing F5. The last method would not work with a file list which is representing a result of a file search, because F5 will cause a reread of the current directory. ═══ 5. Basic file and directory management ═══ Describing the important and frequently used operations on files and directories. ═══ 5.1. Copying ═══ Copying files and directory structures Key Program Area Function Scope C Filelist Copy File/Directory Highlighted Entry Ctrl-C Filelist Copy File/Directory Marked Entries A destination dialog will be displayed so that you can specify a destination for the files/directories to be copied to. If the specified destination or the result of path assembling is a nonexisting directory ADU/2 will create it. You can force ADU/2 to assume the destination as a directory if the last character is a backslash. The Copy function in the file list area copies single files, multiple files and entire directory structures to the specified destination. If the status of confirmation is ON you will be prompted if an existing file is to be overwritten. When you are prompted for the target path of the copy operation, a list of recently used target paths could be provided by pressing F4. UNC-Names are allowed as a target of a copy operation. ═══ 5.2. Deleting ═══ Deleting files and directory structures Key Program Area Function Scope D Filelist , Tree View Delete File/Directory Highlighted Entry Ctrl-D Filelist Delete File/Directory Marked Entries 'D' deletes the highlighted entry. If this entry is a directory ADU/2 will ask for confirmation no matter what the status of the confirmation switch is. Deleting a directory will delete any subtree and contained files based on this entry. 'Ctrl-D' works on all marked list entries. ═══ 5.3. Editing ═══ Editing files with an external editor Launches an external editor specified by the environment variable ADUEDIT or by default the OS/2 System editor e.exe if ADUEDIT isn't defined. Temporary definition of the editor is done in the options menu / name of editor. Using the ADU/2 Hexeditor First invoke the view function by pressing 'V' while the desired file is highlighted. The Hexeditor is called from the file viewer by pressing 'E'. ═══ 5.4. Renaming ═══ Renaming files and directories Key Program Area Function Scope R Filelist , Tree View Rename File/Directory Highlighted Entry Renaming works on files and directories. You will get an error message Access denied if the new name still exists. Note ! Wildcards are not supported. ═══ 5.5. Moving ═══ Moving files and directory structures Key Program Area Function Scope M Filelist Move File/Directory Highlighted Entry Ctrl-M Filelist Move File/Directory Marked Entries Moving works on files and directory structures. When you are prompted for the target path of the move operation, a list of recently used target paths could be provided by pressing F4. Note ! Moving across different drives is not supported. ═══ 5.6. Creating Directories ═══ Creating Directories Key Program Area Function Scope F8 Filelist Make Directory Current drive F8 Tree View Make Directory Beneath the highlighted directory By using 'F8' from the file list area it is possible to create multilevel directory structures in a single step, even on a different than the current drive. Assume your current drive is C: and you need the structure: D:\PRIVATE\LOTUS\DATAS\TAXES Within the file list this task is done with one input step. Press F8 and then type the exact needed structure. In the Tree View area things are different. You can only create structures beneath the highlighted node. Even a preceding backslash in the entry field will create the new directory beneath the current highlighted directory node. ═══ 5.7. Viewing Files ═══ Viewing Files Key Program Area Function Scope V Filelist View File Highlighted Entry Ctrl-V Filelist View File Marked Entries Invoking the file viewer with Ctrl-V allows to view all marked file in a round robin manner by pressing the TAB key in the file view panel. Get a detailed function overview in the File Viewer Key Reference. There are two basic modes of viewing the contents of a file: HEX and ASCII. You can toggle between these two modes with F2. For the ASCII mode there are two submodes: RAW and FORMATTED. Use Ctrl-F2 for switching the submode. The RAW mode All characters are displayed. Carriage Return (h0D) and Line Feed (h0A) and Tabs (h09) are shown in their ASCII interpretation. 79 characters per line are displayed. The FORMATTED mode A line feed happens for each (h0A) and a preceding carriage return (h0D) created by most editors is suppressed. Tabs are translated into one space (h20). ADU/2 analyses the first part of a file to choose the appropriate display mode. For example: if ADU/2 detects embedded NULL characters it assumes a non text file. If necessary press Ctrl-F2 to switch to the opposite mode. If ADU/2 detects a ZIP, ZOO, ARJ or LZH archive a listbox with the archive contents is shown. See the description of Viewing Archives. ═══ 5.8. Viewing ZIP, ZOO, ARJ or LZH Archives ═══ Viewing ZIP, ZOO, ARJ or LZH Archives ADU/2 Version 2.2 supports the archive view of files processed by programs which create the ZIP, ZOO, ARJ or LZH format. The extension .ZIP , .ZOO , .ARJ or .LZH is not mandatory. Press 'V' to have a look at the archive's directory. ADU/2 will analyse the file and show the archive directory if a supported format is detected, otherwise the standard file browse is shown. Pressing 'V' in the list box of an archive directory will branch to the normal file browse even for a compressed file. ═══ 5.9. Printing ═══ Print files, lists and trees In general ADU/2 print functions are prompting you for the name of a printfile. For a direct print specify a print device like LPT1, LPT2 ... or an UNC-Name instead of a filename. Printing the contents of a file: You can print one or more ASCII-File(s) by invoking the copy function with 'C' or Ctrl-C (for all marked entries) and specify a print device like LPT1, LPT2 The same is true for binary files processed by printer drivers e.g. PostScript files which could be using the copy function and a printer resource as destination. Printing the contents of a list: Press 'P' in the filelist area to create a printfile of all list entries. Ctrl-P will do the same restricted to all marked entries. Printing a directory tree: Press 'P' in the Tree View area to create a printfile of the displayed directory tree. Printing the directory list: Press 'P' in the allocation list area to create a printfile of the displayed directory list. ═══ 5.10. Setting Attributes ═══ Setting Attributes Key Program Area Function Scope A Filelist Set/Reset Attributes (HSRA) Highlighted Entry Ctrl-A Filelist Set/Reset Attributes (HSRA) Marked Entries A input dialog will be displayed so that you can specify the attributes to set and/or reset. Example: To reset an attribute HIDDEN and set READ-ONLY in one step, the entry field must contain the enries R-H ═══ 5.11. Searching and Scanning files ═══ Searching and Scanning files This is one of the most powerful functions of ADU/2. Searching files is ruled by the following conditions: o File Mask ( Wildcards * , ? ) o Basepath o String matching in the files contents o Drives to include in scan o File size upper and/or lower limits o Extended Attributes size upper and/or lower limits o File Attributes (S)ystem (H)idden (R)eadonly (A)rchive o Last Write Date/Time upper and/or lower limits o Last Access Date/Time upper and/or lower limits o Creation Date/Time upper and/or lower limits The result is a filelist with nearly the same range of functions as in the normal filelist. The main different is that pathnames are included. Press Ctrl-F2 to hide the pathnames. Examples especially for network administrators: 1) Delete all files with an extension .bak which are last accessed before 1.1.92. Easy task for ADU/2. 2) Search all files in user directories which are larger than 500 KBytes. You may encounter all the black sheeps using network drives for backup purposes. 3) An application has recently created some files, and you don't know where. It's easy to restrict a file search with ADU/2 to an interval for the creation or last writing date/time. ═══ 5.12. Connections to remote file systems ═══ Connections to remote file systems Establish LAN-Connections Pressing 'J' assigns a drive to a LAN resource. Example : You got an IBM LAN-Server or a Microsoft LAN-Manager named APPSERV and a shared resource named APPSDATA. After pressing 'J' the drive to assign is by default the next free unassigned drive. Type \\APPSERV\APPSDATA in the entry field for the 'shared name'. 'K' releases a LAN-Connection to drive. ═══ 5.13. Changing filename to upper/lower case ═══ Change the case of file/directory names on HPFS drives Simply press F7 to swap the highlighted entry to upper case, Shift F7 for lower case. To work on a group of list entries, mark them and press Ctrl-F7. You will be prompted for the mode of change ( means to upper or lower). ═══ 6. Directory Tree View ═══ Describing the features of the tree view of directory structures ═══ 6.1. The tree display ═══ Directory structures shown as a tree Get a detailed function overview in the Tree View Key Reference Size Modes Press F2 in the tree screen to change the size mode. The allocated space is shown beside each directory name. The following modes are available by pressing F2 multiple times: - no size shown (default) - space allocated in directories - sum of space allocated in subtrees - extended attributes size related to the directory itself - a little dot preceding the directory name indicates the existence of extended attributes for this name. This is similar to the little 'x' in the file list screen. Get a more handy tree display Restrict the tree display to one or two levels by pressing '1' or '2'. Pressing '0' will expand all branches. Collapsing or expanding of a single branch could be done with '-' or '+' for the highlighted tree entry. Clicking the left mouse button on the horizontal tree lines will hide the subtree. The tree line will then end with an arrow representing a hidden subtree. Clicking on these arrows will unhide the subtree. ═══ 6.2. Fast access to directory substructures ═══ Reading a substructure of a directory Reading the whole directory structure of a drive could be a very slow process. Especially on network drives with thousends of diretories the time consumption is tremendous. If only a substructure is of interest do the following: Make the base point of the substructure the current directory using the filelist. Press F9 and the substructure will be read and then ADU/2 branches to the Tree View mode. Note! ADU/2 can hold only one directory tree per drive in memory. There is no difference between subtrees and complete trees. So calling the Tree View mode for a drive where only a subtree was scanned, you will only see a part of the whole tree unless a refresh is done by pressing F5. This will cause a directory scan based on the root. ═══ 6.3. Conserving and reading data of directory structures ═══ Conserving and reading data of directory structures Once a big directory tree of a slow media like a CD-ROM or MO-Disk is read, this directory structure data could be saved in a file. Do this by pressing ALT-W in the Tree View mode. You will be prompted for a filename. On a CD-ROM this data will be forever up to date. But even on network drives the whole directory data won't change so fast. You could refresh parts of interest by pressing Ctrl-F5 at the base node of these parts. Reading the previous saved directory data is done with Alt-R. This key is valid in the File List and the Tree View panel. You will be prompted for the filename and the drive to assign to these data. The background for this choice is, that on network drives the logical drive assignment could be different from the moment of reading the tree data. The default is always the original drive. ═══ 7. Directory List View ═══ Describing the features of the list view of directory structures. List view of a directory structure means that each directory is represented by one entry in this list. The entry contains the full path of each directory, the sum of filesizes in this directory, the size of Extended Attributes linked to it and the sum of all filesizes in all subdirectories. ═══ 7.1. Disk space allocation list ═══ Space consumption listed by directories A directory structure read by ADU/2 could be displayed in two modes. The first mode is the Tree View. From this mode you can change to the Directory List by pressing the TAB key. This is the only way to get into this special mode. It doesn't matter if the tree represents only a substructure of the whole disk. In this case the list will represent only the substructure. This could be an advantage when working on large disks. Scanning a subtree by pressing F9 with IBMCPP as the basepoint, you may get a list like this: Bytes in Tree Directory EAs Path 6,362,246 6,362,246 1,089 \IBMCPP\DLL 6,168,908 6,168,908 967 \IBMCPP\BIN 5,021,903 5,021,903 1,336 \IBMCPP\HELP 4,740,654 4,740,654 1,184 \IBMCPP\LIB 3,223,215 3,223,215 13,821 \IBMCPP\IBMCLASS 28,586,303 530,251 0 \IBMCPP 431,074 431,074 0 \IBMCPP\WKFRAME\MAHJONGG 242,406 233,584 1,432 \IBMCPP\INCLUDE 231,501 231,501 0 \IBMCPP\SAMPLES\ICLUI\HELLO6 130,188 130,188 0 \IBMCPP\SAMPLES\ICLCC 125,195 125,195 0 \IBMCPP\TUTORIAL\DEBUGGER\MCELCV 86,278 86,278 0 \IBMCPP\SAMPLES\ICLUI\HELLO5 78,001 78,001 609 \IBMCPP\LOCALE D: Vol: DISK_D Count: 68/68 Free(KB): 46,126 Filter: OFF Explanation: The list consists of 4 columns. 1) Bytes in Tree That's the sum of all filesizes in all directories beneath the basepath listed in column 4. 2) Bytes in Directory Just the sum of all filesizes in the directory listed in column 4. 3) EA's The size of the Extended Attributes direct related to the directory 4) Path All possible paths in the substructure read by ADU/2. For path lengths exceeding the display limit use the right direction key to scroll more information. For an info on a single path press 'Z' to zoom the path of the highlighted entry to it's full extent. The default sort mode is : sort by size. The sort mode could be changed by calling the sort dialogbox with the key 'S'. The directory list feature provides a detailed overview about the allocation of space on your disks. This may be extreme useful for investigation of wasted space on network drives. ═══ 7.2. Setting list filters ═══ A condensed overview by setting appropriate filters Ctrl-F calls the dialog for setting a filter. Especially on network drives or large disks it is very convenient to reduce the number of list entries by a filter. Supported filter conditions: o Basepath o Bytes in tree o Bytes in directory o Bytes in Extended Attributes o Number of directory levels Filter conditions are logical linked by the 'AND' operation. That means all conditions must be simultaneous true for an entry that is a member of the displayed list. ═══ 8. Launching programs ═══ Discussing the feature of starting programs from inside ADU/2 ═══ 8.1. Launching the highlighted list entry as a program ═══ Launching the highlighted list entry as a program Pressing 'RETURN' or a mouse doubleclick on a file list entry (if the entry is no directory) brings up the 'Execute' dialog box. The first entry field 'program' contains the list entry. You can override this entry by any name of a program that is located in the current directory or could be reached via the path statement. A list of the last executed programs is shown by pressing 'F4' while the cursor is in the first entry field. The list contains three default entries at the start time of ADU/2: COMMAND.COM, CMD.EXE and WINOS2.COM. You can paste any list entry to the entry field by pressing 'RETURN'. The second entry field 'Related' specifies the relationship of the child program to the mother process (ADU/2). This entry is initially set to 'Y'. Changes to this value will be kept only for the current ADU/2 session. A detailed discussion of the relation parameter could be found under the headline: Related or not related starting of programs. The third entry field takes additional parameters for the program execution just like a start from the command line. Note: An executable file may not allow all session modes for execution. See 'The execution (session) mode of a program' for further details. ═══ 8.2. List entries as arguments for another program ═══ Starting a program with a list entry as an argument 'Alt-RETURN' opens a dialog box with entry fields for specifying the name of an executable file to run. The highlighted entry is taken as one parameter. There are two more entry fields for specifying additional parameters. Example: You want to search a special ZIP file. You may have invoked the seek and scan file function of ADU/2. The result could be a more or less large file list with full qualified long pathnames. To uncompress a file of this list highlight it and press 'Alt-RETURN'. Specify your favorite 'unzipper' as the file to be executed. The additional entry fields take parameters like target directory for the uncompressed files and various other options. Most characteristics of the above feature dealing with the execution of a program are discussed in 'Launching the highlighted list entry as a program'. ═══ 8.3. Related or not related starting of programs ═══ The relationship of a program started from inside ADU/2 ADU/2 always starts a program in an own session. This is necessary for starting programs in session modes different from ADU/2 (PM Applications for example). The relation of the new session in respect to it's mother process ADU/2 is controlled by the dialog box entry field 'RELATED'. An entry 'N' means the new session is independent and will continue even if ADU/2 is terminated. An entry 'Y' will establish a dependent session and a termination of ADU/2 will abort this session. Make the following considerations: Starting programs in a dependent session is an appropriate way for testing purpose, because there should be no risk of loosing important data when ending ADU/2 unintentional. There is another advantage, when ending the dependent child session you will directly return to the ADU/2 session. Launching applications with independent sessions is safer because of the possibility of data loss. Usually you have to call the task list to get back to the ADU/2 session. ═══ 8.4. The execution (session) mode of a program ═══ The execution (session) mode of a program The session mode for non PM-Applications could be 'windowed' (called seamless for WIN-OS2) or 'fullscreen' . This is valid for OS/2 , DOS and WINDOWS applications. The default session mode is always the session mode of ADU/2. Override this by choosing the opposite session mode in the dialog box. Note! Some OS/2 character based applications don't support the 'windowed mode' so ADU/2 will start them in a 'fullscreen' even if your choice was 'windowed'. ═══ 9. Miscellenous features ═══ This section describes various features of ADU/2. ═══ 9.1. Invoking an OS/2 System prompt from inside ADU/2 ═══ Invoking an OS/2 System prompt from inside ADU/2 Press O in file list or tree view area to get a OS/2 command line prompt. The appearence of the prompt will change. There is a preceding ADU/2 in the prompt string to indicate that this OS/2 session is related to ADU/2. If your normal prompt string is [C:\] , it changes to ADU/2 [C:\]. You could start ADU/2 once again from this command line. Also another OS/2 command line could be invoked. This will result in a prompt string ADU/2 ADU/2 [C:\]. This should remind you of two chained ADU/2 programs in memory. Hint ! You could use ADU/2 as a fast directory changer especially for long pathnames. Once reached the desired working directory press O and perform your tasks. Restrictions ! You could not start a PM type program from the ADU/2 System prompt if you have launched a program from inside ADU/2 and this program is still related to ADU/2 ( see 'Related or not related starting of programs' ) The error message you will get is SYS1059 ═══ 9.2. Hexeditor ═══ Using the ADU/2 Hexeditor. Select a file in the file list and press V to activate the browse mode. Navigate to file position where the editing should take place. You may use the find function ( Key F )to locate the wanted part of the file. Press E to change to the hex editing mode. A cursor will appear in hex interpretation of the file (left screen side). In this area input values are restricted to 0..9 and A..F. To do inputs in ASCII mode change the input area with the TAB key or use the mouse. The editing area is 18 lines at 16 bytes = 288 bytes. You have to stop working in this area by saving changes or leaving the edit mode before you could do any editing outside this 288 bytes. ESC or F3 stops the editing mode. F4 saves changes. There will be a confirmation dialog if changes took place. ═══ 9.3. Display an ASCII - Table ═══ Display an ASCII - Table In most working areas an ASCII table is available. It appears after pressing ALT-A. F2 switches the display mode between ASCII and HEX. ═══ 9.4. The dynamic disk space summary ═══ The dynamic disk space summary Monitoring the diskspace of all defined disks Ctrl-L lists all available drives and their free space. The initial automatic update cycle is 6 seconds. This can be decreased to 1 second and increased by steps of 5 seconds. This feature might be useful for LAN-Drives or a background copy process. If provided that the swapper.dat is in the boot drive's default path \OS2\SYSTEM, the swapper size is also displayed. A configuration of different paths is not supported. ═══ 9.5. Show the entry screen ═══ Show the entry screen F12 displays the entry screen from which ADU/2 was started. If ADU/2 was started from the WPS this screen will be blank. ═══ 9.6. A look at the Extended Attributes ═══ A look at the Extended Attributes Some files and directories are linked to Extended Attributes. This is indicated by a little x in the attributes column of the file list and a little dot which precedes the directory name in tree view. To get a rough look at the contents of the Extended Attributes press X. This brings up a list box containg the EA's data. You could choose between the ASCII and the HEX mode display by pressing F2. ═══ 9.7. The application type of an executable file ═══ The application type of an executable file Press the key Z and you will get a condensed view of: - the whole filename (if exceeding the FAT 8.3 naming convention) - creation date and time - last write date and time - last access date and time - File size - Extended Attributes size - Standard Attributes - Standard Attributes - Application Type like VIO DOS DLL Protected Memory DLL WINDOWS 32-Bit FAMILY PM-Window OS/2 FULLSCREEN DEVICE DRIVER (virtual,physical) ═══ 9.8. Control the confirm status ═══ Control the confirm status The default status of the confirm toggle is ON. As a result of this status you are prompted for confirmation in the case of: - deleting - overwriting - case changing ALT-C toggles the confirm status ( only in the file list screen ) While processing a group of files/directories you can override the confirm status temporary. Choose 'Rest without confirm' when the first confirmation dialog comes up. ═══ UNC-Name ═══ UNC-Names are names build by the Universal Naming Convention Example: \\server1\apps where server1 is the name of the server where resource apps (netname) resides ═══ confirmation ═══ The confirm status can only be changed in the filelist area by pressing Alt-C. The status has effect on deleting, overwriting while copying and changing the case of a filename. Switching the confirmation temporary off While processing a group of files/directories you can overide the confirm status temporary. Choose 'Rest without confirm' when the first confirmation prompt comes up. ═══ 10. Limitations ═══ Discussing the known limitations related to ADU/2 ═══ 10.1. Limits in capacity ═══ Limit of entries in a filelist A filelist can hold up to 2180 entries. A result of a file scan (Ctrl-S) is also limited to this number. The message you will get is 'Array for filedata exhausted' Limited number of directories for one tree There is limit of 15000 directories per drive in the tree view. However we know nobody who has encountered this limit. Even the biggest network drive should not reach this number. ═══ 10.2. Drawbacks in functions ═══ Starting programs from ADU/2 on a diskette booted system You will get an error message SYS461 when starting a program from inside ADU/2 on a diskette booted system. Consider, that the session manager is not active for those configurations. As a result of this it's not possible to start an external editor from ADU/2. As a workaround you may call a system prompt by pressing 'O' in the file list area and call the editor from the command line. Drive connections to NFS resources Although using NFS-resources by ADU/2 is no problem, it's not implemented to establish a new connection to a NFS-resource. Killing existing links means no problem. .* ═══ 11. Key References ═══ List of key assignments and functions for the ADU/2 panels. ═══ 11.1. File List ═══ File List Key Reference Key Function C Copy file or directory tree D Delete file or directory tree E Call external editor with highlighted entry as parameter F Search for string in all list entries G Copy file(s) from somewhere in the current directory J Assign a file network resource K Kill a link to file network resource L Set current drive M Move file or directory tree on the same drive N Next occurrence of string O OS/2 command prompt P Print complete file list Q Quit ADU/2 R Rename file or directory S Set sort mode V View file contents (and edit in hex mode) X Show the contents of the Extended Attributes (Hex/ASCII) Z Show a condensed view of file information F2 Toggles date mode ( last write, last access , creation ) F5 Refresh list data F7 Change highlighted entry to upper case F8 Create directory F9 Read subtree data and go to the Tree View display F12 Show the entry screen (where ADU/2 was started) Alt-A Display an ASCII-Table Alt-C Toggle the confirm status (ON/OFF) Alt-T Go to the Tree View Alt-X Ends ADU/2 immediatly Ctrl-A Set/Reset attributes (HRSA) of marked files or directories Ctrl-C Copy marked files or directory trees Ctrl-D Delete marked files or directory trees Ctrl-L Dynamic diskspace overview for all drives Ctrl-M Move marked files or directory trees on the same drive Ctrl-V View marked files contents (and edit in hex mode) Space Bar Mark/Unmark the highlighted entry Ctrl-S Call the Seek and Scan files panel Ctrl-T Mark all entries which are no directories Ctrl-U Unmark all entries + Set a selection mask for marking - Set a selection mask for unmarking ? Set a mask for reading files/directories in the current directory \ Make the root directory current RETURN Execute highlighted entry. If it is a directory make it current Alt-RETURN Take entry as a parameter for an executable Shift-F7 Change highlighted entry to lower case Ctrl-F7 Change case of marked entries End Move highlighted bar to the last displayed entry Home Move highlighted bar to the first displayed entry Ctrl-End Move highlighted bar to the last entry in list Ctrl-Home Move highlighted bar to the first entry in list ═══ 11.2. File Viewer ═══ File Viewer Key Reference Key Function E Edit file in the hex mode F Search for string G Go to previous set marker N Next occurrence of string O Jump to byte offset S Set marker Alt-A Display ASCII-Table Alt-X Ends ADU/2 immediatly F2 Toggles ASCII/HEX display mode F5 Refresh file size F10 Opens the main menu Ctrl-F2 Toggles RAW/FORMATTED mode ALT-F12 System-Info Home Jump to the beginning of file End Jump to the end of file TAB Load next marked file for viewing (If Viewer was invoked by Ctrl-V) ESC Return to the file list area ═══ 11.3. Directory Tree View ═══ Tree View Key Reference Key Function D Delete directory F Search string in all directory names L Set current drive N Next occurrence of string O OS/2 command prompt P Print directory tree R Rename directory X Show Extended Attributes Z Display the full name of path and directory - Hide substructure + Show hidden substructure 1 Display only the first directory level 2 Display two directory levels 0 Show all levels \ or HOME Jump to the root directory F2 Toggles size mode F5 Refresh the whole directory tree F7 Change directory name to upper case F8 Create directory F9 Read only subtree F10 Opens the main menu Shift-F7 Change directory name to lower case Ctrl-F Set size filter Ctrl-F5 Refresh only the current subtree Alt-L Edit voloume label Alt-R Read tree data from disk Alt-W Write tree data to disk Alt-X Ends ADU/2 immediatly TAB Display all directories in a listed form RETURN Make the highlighted entry to the current directory ESC Return to the file list area ═══ 11.4. Directory List View ═══ Directory List Key Reference Key Function F Search string in all directory names L Set current drive N Next occurrence of string O OS/2 command prompt P Print the displayed directory list S Set Sort mode X Show Extended Attributes Z Display the full name of path and directory Ctrl-F Set filter Alt-L Edit voloume label Alt-X Ends ADU/2 immediatly F10 Opens the main menu TAB Go back to the Tree View mode RETURN Make the highlighted entry to the current directory ESC Return to the Tree View mode